6.1.3 OTC 지불 주문 생성

#간단한 설명: OTC를 통한 법정화폐 인출

• 요청방법 : POST
• 요청 인터페이스: https://gateway-domain/wallet-trade-merchant/v1/otc/payment/create
• 요청 미디어 유형(JSON 데이터 형식)Content-Type: application/json

요청 매개변수

매개변수 이름	유형	필수	매개변수 의미	매개변수 설명
key	string	예	판매자 키	API키
localOrderId	string	예	판매자 플랫폼 현지 주문 번호	판매자 플랫폼은 로컬에서 고유한 주문 번호를 생성합니다
localUserId	string	아니요	판매자 플랫폼 로컬 사용자 ID	판매자 플랫폼 로컬 사용자 ID
notifyUrl	string	아니요	콜백 주소	주문이 성공적으로 처리된 후 API 콜백을 통해 가맹점 주소로 안내됩니다. (콜백 내용은 하단 참조)
currency	string	예	출금통화	기본 CNY
amount	number	예	출금금액	할당량을 사용자 정의하거나(채널 수수료 할인을 받을 수 없습니다. 이 주문의 기본 거래 속도는 지금입니다) 문서 6.1.2 인터페이스를 통해 주문 금액을 얻을 수 있습니다(이 금액은 채널 수수료 할인을 누릴 수 있습니다) 는 소수점 이하 두 자리까지 정확할 수 있습니다
method	string	예	결제방법	ALIPAY(알리페이), UNIONPAY(은련카드), WECHAT(위챗), DIGITAL_RMB(디지털 RMB)
paymentData	json	예	결제정보	아래의 코드 요청 샘플을 참조하세요
└수취인 └계정ID	└수취인 └계정ID	└카드번호 └수취인 └은행명	└수취인 └지갑코드	string
speed	string	예	거래 속도	문서 6.1.1 인터페이스를 통해 얻을 수 있습니다. (NOW인 경우 이 주문은 매칭 풀에 들어가지 않고 운영자가 직접 수동으로 처리한다는 의미입니다.)
sign	string	예	서명	자세한 내용은 서명 알고리즘을 참조하세요.

json 샘플 요청

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "899952123",
  "localUserId": "4114",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo1/notify/test",
  "currency": "CNY",
  "amount": 100,
  "method": "UNIONPAY",
  "paymentData": {
                    // 银联卡
                    "payee":"柯南",
                    "cardNo":13888888888,
                    "bankName":"中国银行"
                   
                   //  支付宝
                   // "payee":"柯南",
                   // "accountId":13888888888
                   
                   //  微信
                   // "payee":"柯南",
                   // "accountId":13888888888
                   
                   //  数字人民币
                   // "payee":"柯南",
                   // "walletCode":13888888888                
                  },
    "speed": "NOW",
    "sign":"c6e3c292bb8cafaea50d4001185e6112"
}

응답 예

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
  。        "orderId": 415236189438341,
            "localOrderId": "899952123"
           }
}

응답 데이터 매개변수 설명

매개변수 이름	유형	매개변수 의미
orderId	Long	주문번호
localOrderId	string	가맹점 플랫폼 맞춤 주문 번호

콜백 세부정보

콜백 방법은 POST application/json입니다.

콜백 매개변수 json 예시

{ 
   "amount":"100",
   "currency":"CNY",
   "localOrderId":"8999521232121336",
   "merchantId":302992856974,
   "merchantUserId":"4114",
   "notifyTime":1766134282162,
   "orderCreateTime":1766133956739,
   "orderId":"423044353278405",
   "status":"SUCCESS",
   "sign":"563eabc8cff14e401d426ff385b643ba",
   "key":"9yUreYgTRtit39Dy"
}

매개변수 이름	유형	참여 서명	매개변수 의미	매개변수 설명
amount	decimal	예	주문금액
currency	String	예	통화
localOrderId	String	예	지역 주문 번호
merchantId	Long	예	판매자 ID
merchantUserId	String	예	판매자의 사용자 ID
notifyTime	Long	예	콜백 시간
orderCreateTime	Long	예	주문 생성 시간
orderId	String	예	주문번호
status	String	예	결제현황	성공: 완료됨 | 실패: 실패
sign	String	아니요	MD5 서명	자세한 내용은 서명 알고리즘을 참조하세요
key	String	예	API 키

콜백 알림을 받으면 처리가 완료된 후 메시지가 성공적으로 수신 및 처리되었음을 나타내는 성공 문자열을 직접 반환해 주세요. 시스템이 성공 응답을 받은 후에는 더 이상 콜백을 반복적으로 보내지 않습니다. 예상된 응답을 받지 못한 경우(성공이 반환되지 않거나 예외가 반환됨) 시스템은 단계적 재시도 메커니즘에 따라 최대 14회 재시도하여 콜백 알림을 다시 보냅니다. 현재 재시도 간격은 다음과 같습니다. 15대, 15대, 30대, 180년대, 600년대, 1200년대, 1800년대, 1800년대, 1800년대, 3600년대, 10800년대, 10800년대, 21600년대, 21600년대